home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 23.zip / BS1 part 23 / B.A.D. v4.13.adf / Bad.doc < prev    next >
Text File  |  1991-04-24  |  21KB  |  536 lines

  1. Disclaimer of all Warranties and Liability
  2. ------------------------------------------
  3.  
  4.  
  5. M.V.Micro makes no warranties either expressed or implied, with 
  6. respect to the software contained on this disk, its quality, 
  7. performance, merchantability or fitness for any particular purpose.  
  8. This software is licensed "as is".  The entire risk as to the quality 
  9. and performance of the software is with the buyer.  In no event will 
  10. M.V.Micro be liable for direct, indirect, incidental or consequential 
  11. damages resulting from any defect in the software even if they have 
  12. been advised of the possibility of such damages.
  13.  
  14.  
  15.  
  16. Backups and Duplicates
  17. ----------------------
  18.  
  19.  
  20. M.V.Micro grants to the purchaser of this product the right to make    
  21. duplicates for personal backup only.  The purchaser does not have the 
  22. right to distribute these duplicates, regardless of whether or not a 
  23. fee is charged for such distribution.  This disk is not copy 
  24. protected, and may be installed on a hard disk at will.  However, 
  25. installation on multiple CPUs is specifically prohibited.  Reasonable 
  26. corporate site licenses are available.  Take note that every copy of 
  27. B.A.D is serialized, this serial number is encrypted into the B.A.D 
  28. program.  This number can be used to trace an illegal copy of B.A.D 
  29. back to it's source.  Remember, a program worth using, is worth 
  30. BUYING.
  31.  
  32.  
  33.  
  34. Commercial Use
  35. --------------
  36.  
  37.  
  38. Use of B.A.D for commercial purposes and/or on any distributable disk 
  39. is strictly forbidden unless the following conditions have been met.
  40. You must state on the disk physically and/or magnetically that this
  41. disk was optimized by B.A.D to improve disk performance.  This
  42. statement must be readily available to the end user.
  43.  
  44. You must notify M.V.Micro of your intent in writing.
  45.  
  46.  
  47.  
  48. Notice
  49. ------
  50.  
  51.  
  52. M.V.Micro reserves the right to make improvements to the software 
  53. contained on this disk at any time and without notice.
  54.  
  55.  
  56.  
  57. Introduction
  58. ------------
  59.  
  60.  
  61. Congratulations!  You have purchased one of the most advanced disk 
  62. utilities available for the Amiga.  B.A.D is designed to greatly 
  63. improve the performance of your disks, whether they be floppy disks or 
  64. harddrives.  B.A.D is so easy to operate that you could stop reading 
  65. right now and never return, however we suggest that you keep this 
  66. manual handy just in case the unexpected happens and you need 
  67. additional information.  Those of you who are naturally inquisitive or 
  68. technically inclined may enjoy reading the manual in its entirety.
  69.  
  70. Please take the time now to fill out the Warranty Registration Card 
  71. and mail it back to M.V.Micro.  This entitles you to upgrades at a 
  72. very reasonable charge, customer service, and technical assistance.
  73.  
  74.  
  75.  
  76. Terminology and Conventions
  77. ---------------------------
  78.  
  79.  
  80. Throughout this manual certain words will be used to describe specific 
  81. actions or objects.  Listed below are all words and phrases that have 
  82. special meaning.
  83.  
  84.  
  85.  
  86.    Actions
  87.    -------
  88.  
  89.       Point  - Position the mouse pointer over a screen object.
  90.  
  91.       Click  - Point at object then press the left mouse button once.
  92.  
  93.       Select - Point at object then press the left mouse button twice
  94.                in rapid succession.
  95.  
  96.    Objects
  97.    -------
  98.  
  99.       Gadget - Embossed button identified by red text.     
  100.  
  101.  
  102.  
  103. Getting Started
  104. ---------------
  105.  
  106.  
  107. Boot your Amiga to the Workbench in the normal fashion, if you have 
  108. trouble please consult your Amiga users guide.  Now insert your B.A.D 
  109. disk into any floppy drive.  When your B.A.D disk appears on the 
  110. Workbench select it, a small window will open.  Select B.A.D, once the 
  111. program has loaded, you will be greeted by the B.A.D screen.
  112.  
  113.  
  114.  
  115. Screen Layout
  116. -------------
  117.  
  118.  
  119. In the upper left hand corner there is a small square gadget, this is 
  120. the Close Gadget.  Clicking on this gadget while B.A.D is idle will 
  121. cause B.A.D to exit.  During processing this gadget has no effect.
  122.  
  123.  
  124.  
  125. To the right of the close gadget on the other side of the screen is
  126. the Screen To Back Gadget.  Clicking on this gadget will cause the
  127. B.A.D screen to move behind any other screens that are currently being
  128. displayed.  The screen which is directly behind the B.A.D screen will
  129. now be visible.  You may return to the B.A.D screen at any time by
  130. shuffling through your screens until the B.A.D screen is once again
  131. visible.
  132.  
  133.  
  134. The upper portion of the screen contains a recessed control panel.  
  135. In this panel are five gadgets which control B.A.D, and various 
  136. displays to inform you of B.A.D's progress during processing.  The 
  137. five gadgets are identified by red text which describes their current 
  138. setting.  Displayed on the right side of the panel are Elapsed Time, 
  139. Estimated Time of Completion, and a gas gauge that shows the current 
  140. percent of completion.
  141.  
  142.  
  143. Clicking on the Mode Gadget will bring up the Mode Requestor.  This 
  144. enables you to tell B.A.D what process it should perform on your disk.  
  145. The various modes are described later in this document.
  146.  
  147.  
  148. Clicking on either the Source, Destination, or Virtual gadget will 
  149. bring up the Drive Requestor.  This allows you to select which drives 
  150. will be used during the process.  The Source drive specifies where the  
  151. data you wish to process is located.  The Destination drive specifies 
  152. where the processed data will be written for floppy drives only.  The 
  153. Virtual drive specifies which drive should be used for virtual memory 
  154. caching when processing vary large drives or partitions.
  155.  
  156.  
  157.  
  158. Clicking on the Start gadget will begin the process you have 
  159. specified.
  160.  
  161.  
  162.  
  163. Below the control panel is a large empty area, this is used for the 
  164. grid display while processing.  At the very bottom of the screen is a 
  165. long box that is used to display the grid legend.
  166.  
  167.  
  168.  
  169. Mode Requestor
  170. --------------
  171.  
  172.  
  173. The Mode Requestor allows you to tell B.A.D how you want your disks 
  174. processed.  Also available from the mode requestor is information on 
  175. your version of B.A.D.  To exit click on one of the mode gadgets.
  176.  
  177.  
  178.  
  179. W.B. MODE  (Workbench)
  180. ----------------------
  181.  
  182. Workbench mode is the default mode selected when you first run B.A.D.
  183. When processed in this mode, the entire disk, including all
  184. directories, files, and data will be processed with special preference
  185. given to all files ending with the .info extension- i.e.  icon files.
  186. In this mode all WorkBench operations will be dramatically sped up.
  187. Windows will open very fast, icons will seemingly blaze onto the
  188. screen, and performance will generally rival speeds found only on hard
  189. drives.  Disk thrashing when opening windows will be non-existent!
  190. This mode is designed for those disks that generally are used with
  191. WorkBench.
  192.  
  193. Note that if during the processing of a disk B.A.D. encounters any
  194. directories that do not have any icons, that directory will be
  195. processed in the CLI mode, regardless of the selected mode setting.
  196.  
  197.  
  198. CLI MODE
  199. --------
  200.  
  201. CLI Mode offers advantages over Workbench mode only if the disk to be
  202. processed will never be accessed by Workbench.  Once again, the entire
  203. disk including all directories, files, and data will be processed,
  204. with special attention given to keeping CLI access quite fast.  CLI
  205. users will appreciate this mode, as issuing the 'Dir', 'List', etc.
  206. commands will present very fast output, with no 'disk-thrashing'
  207. whatsoever.  WorkBench operations will perform about the same as a
  208. non-processed disk.  Once again,you should see CLI performance quite
  209. close to that of a hard drive.
  210.  
  211.  
  212. Test MODE
  213. ---------
  214.  
  215. Test Mode is always called before actually starting to move data 
  216. round 
  217. on the disk.  However it is provided as a separate mode to allow you 
  218. to test the directory structure of your disk with out actually 
  219. processing it.  When a problem is found on a disk, B.A.D will open a 
  220. window and inform you of what the problem is and which blocks are 
  221. involved.  Clicking anywhere in this window will cause the window to 
  222. close.  B.A.D will then abort the current process without causing any 
  223. additional harm to your disk.  You may use the information provided in 
  224. the error message to correct the problem with a 'Sector Editor' 
  225. program.
  226.  
  227.  
  228.  
  229. Drive Requestor  (Source, Destination, Virtual)
  230. ---------------
  231.  
  232. Clicking on any one of the three drive selector gadgets will open the
  233. drive requester.  The drive requester functions similarly during
  234. selection of the Source, Destination, or Virtual drive.  The drive
  235. requestor displays a gadget for every valid drive B.A.D could find in
  236. your system.  Your drives are split into two types, Flop, and Hard.
  237. (if applicable.)
  238.  
  239. If you have any ram-based drives (other than the standard RAM:
  240. device) installed on your system, they too will appear in one of the
  241. two lists.  Any ram based devices that are configured similar to a
  242. floppy drive will appear in the Flop list, while all others will
  243. appear in the Hard list.
  244.  
  245. NOTE:  B.A.D.  will purposefully mask out the RAM:  device, as well as
  246. any device starting with the letters 'VD', i.e.  VD0:  or VDK.  This
  247. is because these are not devices in the true sense of the word, but
  248. rather handlers.  Processing of these devices serves no useful
  249. function.
  250.  
  251. You may toggle between the Flop or Hard lists by clicking on the
  252. Flop/Hard gadget located in the lower right corner of the requestor.
  253. This gadget will have no effect if you have no hard drives or ram
  254. based drives mounted on your system.
  255.  
  256. The currently selected drive in each list will appear depressed.  When
  257. you are done making your selection click on the 'OK' gadget.  After
  258. clicking on the 'OK' gadget, the drive requestor will close and the
  259. gadget you initially selected (Source, Destination, or Virtual) will
  260. reflect the device you have chosen.
  261.  
  262.  
  263.  
  264. Source Gadget
  265. -------------
  266.  
  267. This gadget displays the currently selected source drive.  Clicking on
  268. this gadget opens the drive requestor allowing you to change the
  269. source drive as described above.
  270.  
  271. The source drive is the drive B.A.D.  will read from when processing.
  272. This can be any valid drive on your system.  If the current drive
  273. selected is NOT in the Floppy list, the Dest.  gadget will be
  274. disabled.  This means the source drive will be processed in place, in
  275. what is called the 'Single Drive' mode.  The source drive must contain
  276. a non write-protected disk before starting.
  277.  
  278.  
  279. Dest. Gadget
  280. ------------
  281.  
  282. This gadget displays the currently selected destination drive.  
  283. licking on
  284. this gadget opens the drive requestor allowing you to change the
  285. destination drive as described above.
  286.  
  287. The destination drive is the drive B.A.D. will write to when
  288. processing.  This gadget is enabled ONLY when the currently selected
  289. source drive happens to be a floppy drive.  When the Dest. Gadget is
  290. enabled, this means B.A.D. will process the source drive in what is
  291. called the 'Two Drive' mode, and all data read from the source drive
  292. will be processed and written to the destination drive.
  293.  
  294.  
  295. Virtual Gadget
  296. --------------
  297.  
  298. This gadget displays the currently selected virtual drive.  Clicking 
  299. n
  300. this gadget opens the drive requestor allowing you to change the
  301. virtual drive as described above.
  302.  
  303. The virtual drive has very special meaning.  Usually you will not have
  304. to worry about this particular setting, as it is only used when
  305. processing large hard drives or partitions.
  306.  
  307. The virtual drive will ONLY be used when B.A.D. attempts to process a
  308. large hard drive or partition.  Processing these large drives can
  309. consume a fairly large amount of memory, memory which you may not have
  310. available on your system.  If this situation should arise, B.A.D. will
  311. open a window informing you it cannot locate enough ram to process
  312. your drive, and needs to use some empty space on the virtual drive for
  313. temporary storage.  The drive specified by this gadget will be used
  314. for that temporary storage.  A more thorough discussion of how virtual
  315. memory is used follows the section on hard drive processing.
  316.  
  317.  
  318.  
  319. Start Gadget
  320. ------------
  321.  
  322. This gadget will begin the processing of your selected drive,
  323. according to the parameters you have selected.
  324.  
  325.  
  326. Floppy Processing
  327. -----------------
  328.  
  329. To process floppy disks, first select the desired MODE as described
  330. above.  Most users will want to process floppy disks in the W.B. mode
  331. if the disk contains many icons.  If the disk contains mostly data
  332. files and no icons, CLI mode will be the better mode to choose.
  333.  
  334. The next step is to select the drive to use as the SOURCE drive.  This
  335. is the drive where you will place the disk you wished to be processed.
  336. Click on the SOURCE gadget to change the desired source drive.
  337.  
  338. Next, select the DESTINATION drive.  If you have more than one floppy
  339. drive, it is best to select a drive that is different than your source
  340. drive.  This allows B.A.D. to read the data from the SOURCE drive,
  341. process it in memory, and write out the data to a disk in the
  342. DESTINATION drive.  This works much like doing a diskcopy, however the
  343. resultant disk is much faster in terms of access times and operation.
  344.  
  345. For those who have only one drive, you may still process your
  346. floppies.  Simply select DF0:  as both your Source and Destination
  347. drive.  B.A.D.  will process the disk IN PLACE, thus you should make a
  348. copy of it in case something goes haywire while processing it.  This
  349. method of processing takes longer, as there is no destination disk to
  350. write to.  Expect processing times of around 30-45 minutes for a full
  351. disk, with faster times for disks not yet filled.
  352.  
  353. Once you have set these parameters, simply insert the disks into the
  354. drives, and click on the START gadget.  B.A.D.  will proceed to
  355. process the disk according to your setup parameters.  Expect
  356. processing times of 2-5 minutes depending on how full the disk is.
  357. When completed, you will have an copy of your original disk in the
  358. destination drive, identical in every way except for it's speed and
  359. smoothness.  
  360.  
  361. After processing, you should open all windows on the processed disk
  362. the first time with the write-protect set in the write ENABLE mode so
  363. that WorkBench may re-write it's updated .info files.  After this is
  364. done the disk may then be write protected.  Failure to perform this
  365. step will not take advantage of the full speed your new disk can
  366. function at.
  367.  
  368.  
  369.  
  370.  
  371. Hard Drive Processing
  372. ---------------------
  373.  
  374.  
  375. To process your hard drives, select the SOURCE drive (or partition) as
  376. descibed above.  All hard drives are processed in single drive mode,
  377. thus the DESTINATION drive gadget will be disabled.  Select the
  378. desired mode, as explained above, and you are ready to go.  Click on
  379. the START gadget and B.A.D.  will proceed to process the drive
  380. according to the parameters you selected.  Note that you will NOT be
  381. able to access this partition or drive while it is being processed.
  382. Processing times are difficult to predict, but expect a standard 65ms
  383. drive to take 30-45 minutes for every 10 megs that you are using on
  384. the drive.  This is a dramatic improvement over the first releases of
  385. B.A.D., which took 1-2 hours to process the same amount.  When
  386. completed, AmigaDos will automatically load in the disk-validator to
  387. re-validate the drive.  Please note that this validation may take up
  388. to 15 minutes for some drives, so allow the validator to finish before
  389. you try to access the drive at all.
  390.  
  391. The results of processing hard drives are most pleasing.  You will
  392. find the drive to operate much faster in all areas, while head
  393. thrashing will now be nearly eliminated.  Not only will seeks be
  394. reduced, but you will actually reduce wear and tear on your drive as
  395. it does not have to jump all over the place to find what it needs.
  396. Access speeds will now rival that of a RAM DISK!!  This is especially
  397. true of WorkBench operations.  You will find that when opening
  398. WorkBench windows, the drive light will only blip a few times- thus
  399. the drive is feeding DOS the information as fast as it will digest it.
  400. We feel that once you process your drive, you will never want to be
  401. without this added speed and smoothness.  It can become quite
  402. addictive!!
  403.  
  404.  
  405. Virtual Memory
  406. --------------
  407.  
  408. All computers come equipped with memory, otherwise called RAM.  The
  409. amount of ram installed on your Amiga can vary a great deal, from 512
  410. Kilobytes to well over 8 Megabytes.  ( 1 Kilobyte is equal to 1024
  411. bytes, while 1 Megabyte equals 1024 Kilobytes.) To process any disk or
  412. drive, B.A.D.  requires a certain amount of memory to store important
  413. information about the drive.  In particular, hard drives can require
  414. rather large amounts of ram to process.  The larger the drive
  415. capacity, the more memory B.A.D.  will require to complete processing
  416. of that drive.  Some people may have very large drives, yet only 512
  417. Kilobytes of ram, while others may have relatively small hard drives
  418. and a large amount of ram.
  419.  
  420. If you process a large drive, but for some reason you do not have
  421. enough ram, B.A.D. will automatically detect this condition and
  422. request permission to use 'virtual memory'.  
  423.  
  424. Before processing ANY disk, B.A.D.  will first calculate how much ram
  425. really is available.  If necessary, B.A.D.  will use most of the free
  426. ram on the system, leaving a default minimum amount for system use.  A
  427. suggested figure to leave available for the system is shown in the
  428. requester that B.A.D.  opens.  You may modify this figure to suit your
  429. own anticipated needs, however sticking with the suggested amount is
  430. recommended.  Simply type [RETURN] to use the suggested amount.  Next,
  431. B.A.D.  will then determine if the allowed memory usage will be enough
  432. to process the disk.  If it is not, another requester will open
  433. informing you that virtual memory is needed.  Virtual Memory is simply
  434. a technique where empty space on the drive you specify for virtual
  435. storage is used by B.A.D.  This empty space is used much the same way
  436. regular ram is used, though access times for this storage will be much
  437. longer.  This generally results in a longer processing times, 
  438. epending
  439. on what percentage of the ram is actually virtual ram.  
  440.  
  441.  
  442.  
  443. Grid Display
  444. ------------
  445.  
  446.  
  447. In the center of the B.A.D screen there is a large empty area when 
  448. B.A.D is first loaded.  This area is used for the 'Grid Display' 
  449. uring 
  450. processing.  Immediately after the Start gadget is clicked B.A.D will 
  451. reconfigure the sunken grid area to best represent the size of the 
  452. Source drive.
  453.  
  454.  
  455.  
  456. The legend information for the grid will be displayed at the very 
  457. bottom of the screen.  The legend will inform you of the total number 
  458. of cells within the current grid, how many disk blocks are represented 
  459. by each cell, and the total number of disk blocks on the source drive.
  460.  
  461.  
  462.  
  463. Each grid cell represents a given number of disk blocks.  Colors are 
  464. used to represent the relative percentage of blocks within a cell that 
  465. still need processing.  Typically the grid will start out mostly red 
  466. and gradually change to all light green.  Each cell may be any one of 
  467. six colors, these colors are:
  468.  
  469.  
  470.  
  471.    Blue        - No blocks active, free disk space
  472.  
  473.    Red         - 0 - 20%
  474.  
  475.    Orange      - 21 - 40%
  476.  
  477.    Yellow      - 41 - 60%
  478.  
  479.    Dark Green  - 61 - 80%
  480.  
  481.    Light Green - 81 - 100%
  482.  
  483.  
  484.  
  485. At the completion of the Test Mode the grid will be filled in with 
  486. either all green or all red depending on which mode B.A.D is using, 
  487. Single or Two drive modes respectively.  This represent where the 
  488. active data is located on the disk.  If processing continues, and 
  489. single drive mode is active the grid will be updated to represent what 
  490. processing needs to be performed, after the preprocessing is complete.  
  491. At this point the grid will be mostly red, B.A.D will then proceed 
  492. with the task of rearranging all the data on the disk.  As processing 
  493. continues the grid will gradually change to all light green in color.  
  494. At the completion of processing the grid will be light green and blue.   
  495. The green areas represent active data on the disk and the blue areas 
  496. are free disk space.
  497.  
  498.  
  499.  
  500. Two drive mode uses a slightly different approach to display what is 
  501. happening.  Here the problem is displaying what is happening on two 
  502. different disks using one grid.  Our solution was to use a truth table 
  503. to select which color a cell should be.
  504.  
  505.  
  506.  
  507.    Red         - No processing completed
  508.  
  509.    Orange      - Block read but not written
  510.  
  511.    Dark Green  - Block written but not read
  512.  
  513.    Light Green - Block read and written
  514.  
  515.  
  516.  
  517. What this means is that the grid will initially start out as all red.  
  518. As blocks are read from the source drive there corresponding grid cell 
  519. will change to either orange or light green.  When the buffer is full 
  520. B.A.D will begin to write the data out to the destination disk.  The 
  521. corresponding grid cells will change to either dark or light green.  
  522. Then B.A.D has completed processing the grid cell colors represent the 
  523. following:
  524.  
  525.  
  526.  
  527.    Blue        - Free disk space on both disks
  528.  
  529.    Orange      - Active data on Source, Free space on Destination
  530.  
  531.    Dark Green  - Free space on Source, Active data on Destination
  532.  
  533.    Light Green - Active data on both Source and Destination disks
  534.  
  535.  
  536.